<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
  <head>
    <title>
Bugzilla::Flag</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <link rel="stylesheet" title="style" type="text/css" href=".././../../../style.css" media="all" >

</head>
  <body id="pod">
<p class="backlinktop"><b><a name="___top" href="../index.html" accesskey="1" title="All Documents">&lt;&lt;</a></b></p>
<h1>Bugzilla::Flag</h1>
<div class='indexgroup'>
<ul   class='indexList indexList1'>
  <li class='indexItem indexItem1'><a href='#NAME'>NAME</a>
  <li class='indexItem indexItem1'><a href='#SYNOPSIS'>SYNOPSIS</a>
  <li class='indexItem indexItem1'><a href='#NOTES'>NOTES</a>
  <ul   class='indexList indexList2'>
    <li class='indexItem indexItem2'><a href='#METHODS'>METHODS</a>
  </ul>
  <li class='indexItem indexItem1'><a href='#SEE_ALSO'>SEE ALSO</a>
  <li class='indexItem indexItem1'><a href='#CONTRIBUTORS'>CONTRIBUTORS</a>
</ul>
</div>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="NAME"
>NAME</a></h1>

<p>Bugzilla::Flag - A module to deal with Bugzilla flag values.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="SYNOPSIS"
>SYNOPSIS</a></h1>

<p>Flag.pm provides an interface to flags as stored in Bugzilla.
See below for more information.</p>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="NOTES"
>NOTES</a></h1>

<ul>
<li>Import relevant functions from that script.</li>

<li>Use of private functions / variables outside this module may lead to unexpected results after an upgrade.
Please avoid using private functions in other files/modules.
Private functions are functions whose names start with _ or a re specifically noted as being private.</li>
</ul>

<h2><a class='u' href='#___top' title='click to go to top of document'
name="METHODS"
>METHODS</a></h2>

<dl>
<dt><a name="id"
><code  class="code">id</code></a></dt>

<dd>
<p>Returns the ID of the flag.</p>

<dt><a name="name"
><code  class="code">name</code></a></dt>

<dd>
<p>Returns the name of the flagtype the flag belongs to.</p>

<dt><a name="bug_id"
><code  class="code">bug_id</code></a></dt>

<dd>
<p>Returns the ID of the bug this flag belongs to.</p>

<dt><a name="attach_id"
><code  class="code">attach_id</code></a></dt>

<dd>
<p>Returns the ID of the attachment this flag belongs to,
if any.</p>

<dt><a name="status"
><code  class="code">status</code></a></dt>

<dd>
<p>Returns the status &#39;+&#39;,
&#39;-&#39;,
&#39;?&#39; of the flag.</p>
</dd>
</dl>

<dl>
<dt><a name="type"
><code  class="code">type</code></a></dt>

<dd>
<p>Returns the type of the flag,
as a Bugzilla::FlagType object.</p>

<dt><a name="setter"
><code  class="code">setter</code></a></dt>

<dd>
<p>Returns the user who set the flag,
as a Bugzilla::User object.</p>

<dt><a name="requestee"
><code  class="code">requestee</code></a></dt>

<dd>
<p>Returns the user who has been requested to set the flag,
as a Bugzilla::User object.</p>

<dt><a name="attachment"
><code  class="code">attachment</code></a></dt>

<dd>
<p>Returns the attachment object the flag belongs to if the flag is an attachment flag,
else undefined.</p>
</dd>
</dl>

<dl>
<dt><a name="has_flags"
><code  class="code">has_flags</code></a></dt>

<dd>
<p>Returns 1 if at least one flag exists in the DB,
else 0.
This subroutine is mainly used to decide to display the &#34;(My )Requests&#34; link in the footer.</p>
</dd>
</dl>

<dl>
<dt><a name="match($criteria)"
><code  class="code">match($criteria)</code></a></dt>

<dd>
<p>Queries the database for flags matching the given criteria (specified as a hash of field names and their matching values) and returns an array of matching records.</p>
</dd>
</dl>

<dl>
<dt><a name="count($criteria)"
><code  class="code">count($criteria)</code></a></dt>

<dd>
<p>Queries the database for flags matching the given criteria (specified as a hash of field names and their matching values) and returns an array of matching records.</p>
</dd>
</dl>

<dl>
<dt><a name="create($flag,_$timestamp)"
><code  class="code">create($flag,
$timestamp)</code></a></dt>

<dd>
<p>Creates a flag record in the database.</p>
</dd>
</dl>

<dl>
<dt><a name="extract_flags_from_cgi($bug,_$attachment,_$hr_vars)"
><code  class="code">extract_flags_from_cgi($bug,
$attachment,
$hr_vars)</code></a></dt>

<dd>
<p>Checks whether or not there are new flags to create and returns an array of hashes.
This array is then passed to Flag::create().</p>
</dd>
</dl>

<dl>
<dt><a name="notify($flag,_$bug,_$attachment)"
><code  class="code">notify($flag,
$bug,
$attachment)</code></a></dt>

<dd>
<p>Sends an email notification about a flag being created,
fulfilled or deleted.</p>
</dd>
</dl>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="SEE_ALSO"
>SEE ALSO</a></h1>

<dl>
<dt><a name="Bugzilla::FlagType"
><b>Bugzilla::FlagType</b></a></dt>
</dl>

<h1><a class='u' href='#___top' title='click to go to top of document'
name="CONTRIBUTORS"
>CONTRIBUTORS</a></h1>

<dl>
<dt><a name="Myk_Melez_&#60;myk@mozilla.org&#62;"
>Myk Melez &#60;myk@mozilla.org&#62;</a></dt>

<dd>
<dt><a name="Jouni_Heikniemi_&#60;jouni@heikniemi.net&#62;"
>Jouni Heikniemi &#60;jouni@heikniemi.net&#62;</a></dt>

<dd>
<dt><a name="Kevin_Benton_&#60;kevin.benton@amd.com&#62;"
>Kevin Benton &#60;kevin.benton@amd.com&#62;</a></dt>

<dd>
<dt><a name="Fr&#195;&#169;d&#195;&#169;ric_Buclin_&#60;LpSolit@gmail.com&#62;"
>Fr&#195;&#169;d&#195;&#169;ric Buclin &#60;LpSolit@gmail.com&#62;</a></dt>
</dl>
<p class="backlinkbottom"><b><a name="___bottom" href="../index.html" title="All Documents">&lt;&lt;</a></b></p>

<!-- end doc -->

</body></html>
